Version: 1.0.2

Add or Update MCC Group

Add or update Merchant Country Code (MCC) group. MCC group name is unique, and wherever it exists, the details will be updated in the respective groups.

Method: POST

{{URL}}/cardv2

Headers

Name	Value
Content-Type	application/json

Example

Payload Parameters

Parameters	Description
reference Optional	String Unique reference ID of the request Sample Value: "visadps100045"
transactionType Mandatory	String Type of operation / transaction Constant Value : "ADD_UPDATE_MCCGROUP"
customerId Mandatory	String Unique ID of the customer Sample Value : "100000000006001"
product Mandatory	String Name of the product associated with the card Sample Value: "DEFAULT"
channel Mandatory	Enum Processing channel through which the card transaction happens Valid Values: PULSE VISA_DPS Sample Value :"VISA_DPS"
program Mandatory	String Name of the program to which the card product is mapped Sample Value : "DEFAULT"
mccGroup Mandatory	Object
groupName Mandatory	String The name of the MCC group being added or updated Sample Value : "Mathew MCC"
description Mandatory	String Description of the MCC group Sample Value : "Mathew Mcc group"
mccCodes Mandatory	Array An array of MCC codes to be included in the group Sample Value : "5542"

Parameters

Description

reference

Optional

String

Unique reference ID of the request

Sample Value: "visadps100045"

transactionType

Mandatory

String

Type of operation / transaction

Constant Value : "ADD_UPDATE_MCCGROUP"

customerId

Mandatory

String

Unique ID of the customer

Sample Value : "100000000006001"

product

Mandatory

String

Name of the product associated with the card

Sample Value: "DEFAULT"

channel

Mandatory

Enum

Processing channel through which the card transaction happens

Valid Values:

PULSE

VISA_DPS

Sample Value :"VISA_DPS"

program

Mandatory

String

Name of the program to which the card product is mapped

Sample Value : "DEFAULT"

mccGroup

Mandatory

Object

groupName

Mandatory

String

The name of the MCC group being added or updated

Sample Value : "Mathew MCC"

description

Mandatory

String

Description of the MCC group

Sample Value : "Mathew Mcc group"

mccCodes

Mandatory

Array

An array of MCC codes to be included in the group

Sample Value : "5542"

cURL
C#
Go
NodeJs

curl --location --globoff '{{URL}}/cardv2' \
--header 'Content-Type: application/json' \
--data '{"method":"ledger.CARD.request","id":"1","params":{"payload":{"reference":"visadps100045","transactionType":"ADD_UPDATE_MCCGROUP","customerId":"100000000006001","product":"DEFAULT","channel":"VISA_DPS","program":"DEFAULT","mccGroup":{"groupName":"Mathew MCC","description":"Mathew Mcc group","mccCodes":["5542"]}},"api":{"credential":"{{cred}}","signature":"{{signature}}","apiKey":"{{Api-key}}"}}}'

var options = new RestClientOptions("{{URL}}/cardv2")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("", Method.Post);
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@"    ""method"": ""ledger.CARD.request"",
" + "\n" +
@"    ""id"": ""1"",
" + "\n" +
@"    ""params"": {
" + "\n" +
@"        ""payload"": {
" + "\n" +
@"            ""reference"": ""visadps100045"",
" + "\n" +
@"            ""transactionType"": ""ADD_UPDATE_MCCGROUP"",
" + "\n" +
@"            ""customerId"": ""100000000006001"",
" + "\n" +
@"            ""product"": ""DEFAULT"",
" + "\n" +
@"            ""channel"": ""VISA_DPS"",
" + "\n" +
@"            ""program"": ""DEFAULT"",
" + "\n" +
@"            ""mccGroup"": {
" + "\n" +
@"                ""groupName"": ""Mathew MCC"",
" + "\n" +
@"                ""description"": ""Mathew Mcc group"",
" + "\n" +
@"                ""mccCodes"": [
" + "\n" +
@"                    ""5542""
" + "\n" +
@"                ]
" + "\n" +
@"            }
" + "\n" +
@"        },
" + "\n" +
@"        ""api"": {
" + "\n" +
@"            ""credential"": ""{{cred}}"",
" + "\n" +
@"            ""signature"": ""{{signature}}"",
" + "\n" +
@"            ""apiKey"": ""{{Api-key}}""
" + "\n" +
@"        }
" + "\n" +
@"    }
" + "\n" +
@"}";
request.AddStringBody(body, DataFormat.Json);
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "{{URL}}/cardv2"
  method := "POST"

  payload := strings.NewReader(`{`+"
"+`
    "method": "ledger.CARD.request",`+"
"+`
    "id": "1",`+"
"+`
    "params": {`+"
"+`
        "payload": {`+"
"+`
            "reference": "visadps100045",`+"
"+`
            "transactionType": "ADD_UPDATE_MCCGROUP",`+"
"+`
            "customerId": "100000000006001",`+"
"+`
            "product": "DEFAULT",`+"
"+`
            "channel": "VISA_DPS",`+"
"+`
            "program": "DEFAULT",`+"
"+`
            "mccGroup": {`+"
"+`
                "groupName": "Mathew MCC",`+"
"+`
                "description": "Mathew Mcc group",`+"
"+`
                "mccCodes": [`+"
"+`
                    "5542"`+"
"+`
                ]`+"
"+`
            }`+"
"+`
        },`+"
"+`
        "api": {`+"
"+`
            "credential": "{{cred}}",`+"
"+`
            "signature": "{{signature}}",`+"
"+`
            "apiKey": "{{Api-key}}"`+"
"+`
        }`+"
"+`
    }`+"
"+`
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'POST',
  'hostname': '{{URL}}',
  'path': '/cardv2',
  'headers': {
    'Content-Type': 'application/json'
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

var postData = JSON.stringify({
  "method": "ledger.CARD.request",
  "id": "1",
  "params": {
    "payload": {
      "reference": "visadps100045",
      "transactionType": "ADD_UPDATE_MCCGROUP",
      "customerId": "100000000006001",
      "product": "DEFAULT",
      "channel": "VISA_DPS",
      "program": "DEFAULT",
      "mccGroup": {
        "groupName": "Mathew MCC",
        "description": "Mathew Mcc group",
        "mccCodes": [
          "5542"
        ]
      }
    },
    "api": {
      "credential": "{{cred}}",
      "signature": "{{signature}}",
      "apiKey": "{{Api-key}}"
    }
  }
});

req.write(postData);

req.end();

Body

{
    "method": "ledger.CARD.request",
    "id": "1",
    "params": {
        "payload": {
            "reference": "visadps100045",
            "transactionType": "ADD_UPDATE_MCCGROUP",
            "customerId": "100000000006001",
            "product": "DEFAULT",
            "channel": "VISA_DPS",
            "program": "DEFAULT",
            "mccGroup": {
                "groupName": "Mathew MCC",
                "description": "Mathew Mcc group",
                "mccCodes": [
                    "5542"
                ]
            }
        },
        "api": {
            "credential": "{{cred}}",
            "signature": "{{signature}}",
            "apiKey": "{{Api-key}}"
        }
    }
}

Response: 200

Response Parameters

Parameters	Description
Id	String Response Id echoed from the request Id Sample Value : "1"
result	Object
mccGroup	Object
id	String Unique identifier of the MCC group Sample Value : "673dacfe36e456cc9c7980d5"
groupName	String The name of the MCC group added or updated Sample Value : "Mathew MCC"
description	String Description of the MCC group Sample Value : "Mathew Mcc group"
mccCodes	Array An array of MCC codes included in the group Sample Value : "5542"
active	Boolean Indicates whether the MCC group is active Sample Value : false
createdDate	String Date and time when the MCC group was created Sample Value : "2024-11-20T09:33:50.157Z"
updatedDate	String Date and time when the MCC group was last updated Sample Value : "2024-11-20T09:33:50.161Z"
isCreatedBridge	Boolean Indicates whether the MCC group was validated via the bridge service Sample Value : false
api	Object
type	String Acknowledgement for type of operation requested for Constant value: " ADD_UPDATE_MCCGROUP_ACK"
reference	String Auto generated reference ID of this acknowledgment Sample value: " REFvisadps100045"
dateCreated	Number Unix timestamp of the response was created Sample value: 1732095230
originalReference	String Original reference ID taken from the request Sample value: " visadps100045"

{
   "id": "1",
   "result": {
       "mccGroup": {
           "id": "673dacfe36e456cc9c7980d5",
           "groupName": "Mathew MCC",
           "description": "Mathew Mcc group",
           "mccCodes": [
               "5542"
           ],
           "active": false,
           "createdDate": "2024-11-20T09:33:50.157Z",
           "updatedDate": "2024-11-20T09:33:50.161Z",
           "isCreatedBridge": false
       },
       "api": {
           "type": "ADD_UPDATE_MCCGROUP_ACK",
           "reference": "REFvisadps100045",
           "dateCreated": 1732095230,
           "originalReference": "visadps100045"
       }
   }
}

Add or Update MCC Group

Method: POST​

Headers​

Example​

Body​

Response: 200​

Method: POST

Headers

Example

Body

Response: 200